\name{plot.Abundance}
\alias{plot.Abundance}
%- Also NEED an '\alias' for EACH other topic documented here.
\title{ ~~function to do ... ~~ }
\description{
    Produce By-Year graphs of Avian Abundance (and Density) Data
}
\usage{
plot.Abundance(data = NULL, station = "ALL", species = "ALL", year = "ALL", group.species = FALSE, group.station = FALSE, ...)
}
%- maybe also 'usage' for other objects documented here.
\arguments{
  \item{data}{ data.frame in proper Ravian point count format}
  \item{station}{ A vector of station codes (PointCountStationIDs) to limit the plot with }
  \item{species}{ A vector of AOU species codes to limit the plot }
  \item{year}{ A vector of the years of data the plot will contain}
  \item{group.species}{ Boolean.  Separate graphs for each species (FALSE) or put all species on one graph (TRUE) but as separate lines }
  \item{group.station}{ Boolean.  Separate graphs for each station (FALSE) or put all the stations on one graph(TRUE) but as separate lines}
  \item{\dots}{ additional variables passed on to internal functions }
}
\details{
   Currently can produce plots of abundance and ultimately will also produce density graphs as well. 
}
\value{
    A graph displayed in the active device.
}

\author{ Mark Herzog \email{mherzog@prbo.org} }

\examples{
palo.data<-getPCdata(database='digir-ro',station="PALO") # load in the data from the BMDE database, filter for only the "PALO" station
palo.abundance<-EstimateAbundance(palo.data,min.month=3,max.month=7) # generates a data.frame of by year abundance, se, and sample sizes
plot.Abundance(palo.abundance,station=c("PALO"),species=c("SOSP"))
# use group.species=TRUE to see multiple species on one graph
plot.Abundance(palo.abundance,station=c("PALO"),species=c("SOSP","AMGO","WREN"),group.species=TRUE)
}

% Add one or more standard keywords, see file 'KEYWORDS' in the
% R documentation directory.
\keyword{ hplot }
